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Overview 


This document provides information about the following Latitude ON Flash remote management features: 

• Pushing Latitude ON Flash updates to the users 

• Enforcing periodic password updates 

• Choosing the desired configuration settings 

The general process for remotely configuring the settings of your Latitude ON Flash is shown below. 
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Writing XML Configuration Files 

Latitude ON Flash allows you to remotely configure the settings using XML This section of the document provides a few 
sample XML codes for remote configuration. 

NOTE: You must write the XML commands using a text editor before you start configuring Latitude ON Flash. 


ChangeAllUserPassword.xml 

The following code allows you to ensure that all the users change their passwords at first log in, after the remote settings are 
dispatched: 


<?xml version="1.0" encodinq= n utf-8"?> 

<cmdstore xmlns : xsi="http : //www.w3.org/2001/XMLSchema-instance" 
xsi : noNamespaceSchemaLocation= n DVMRemoteCmd.xsd n > 

<cmd> 

<allUser action="changeUser"></allUser> 

</cmd> 

</cmdstore> 


ChangellserPassword.xml 


The following code allows a specific user to change his/her password: 


く ？ xml version="1.0" encodinq="utf-8"?> 

<cmdstore xmlns : xsi="http :/ /www.w3.org/2 001 /XMLSchema-instance" 
xsi : noNamespaceSchemaLocati 〇 n= n DVMRemoteCmd.xsd"> 

<cmd> 

<allUser action="changeUser"></allUser> 

</cmd> 

</cmdstore> 


If the Statement <singleUser action= n changePassword" user="User "> above is changed to <singleUser 
action= n changePassword n user="useri n >, then the user of the Userl account will be asked to change his password the 
next time he logs into the system. 


DeleteAllUsers.xml 

The following code deletes all users (except the default user): 


く ？ xml version="1.0" encoding="utf-8"?> 

<cmdstore xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation=" 
DVMRemoteCmd.xsd"> 

<cmd> 

<allUser action="deleteUser"></allUser> 

</cmd> 

</cmdstore> 


Deletellser.xml 

The following code deletes a specific user account (User): 


く ？ xml version="1.0" encoding="utf-8"?> 









<cmdstore xmlns : xsi="http : //www.w3.org/2001/XMLSchema-instance" 
xsi : noNamespaceSchema_Loca_tion= n DVMRemoteCmd. xsd n > 

<cmd> 

<singleUser action="deleteUser" user="User"></singleUser> 
</cmd> 

</cmdstore> 


In the above example, the line <singieuser action="deieteUser" user= n user n x/singieuser> deletes the user account 
User. To delete another user account, replace User with the user account to be deleted. 


ConfigBattery.xml 


The following code allows you to configure the power settings: 


く ？ xml version="1.0" encoding= n utf-8"?> 

<cmdstore xmlns : xsi="http :/ /www.w3.org/2 001 /XMLSchema-instance" 
xsi : noNamespaceSchema_Loca_tion= n DVMRemoteCmd. xsd n > 

<cmd> 

<conngPassword interval="10 "x/conrigPassword> 

</cmd> 

<cmd> 

<conrlgPower> 

<battery backlight="1"poweroff="5 n ></battery> 

<acpower backlight="5" poweroff="10"></acpower> 

</configPower> 

く / cmd> 

</cmdstore> 


In the above example: 

• The statement <configPassword intervai="i0"> ensures that the user changes the password every 10 days. 

• The statement く battery backiight= ,f i" poweroff="5"> puts Latitude ON Flash in sleep mode if there is no activity 
for more than a minute (when the computer is using battery power) and forces a Power Off after five minutes of 
inactivity. 

• The statement く acpower backiight="5 M powerof f= ,f io ,f > puts Latitude ON Flash in sleep mode after five minutes of 
inactivity and will Power Off after ten minutes of inactivity, when the computer is on AC power. 


ConfigPassword.xml 


The following code allows the user to change his/her password: 


く ？ xml version="1.0" encodinq="utf-8"?> 

<cmdstore xmlns : xsi="http :/ /www.w3.org/2 001 /XMLSchema-instance" 
xsi : noNamespaceSchemaLocation= n DVMRemoteCmd.xsd n > 

<cmd> 

<conngPassword interval="10"x/conrigPassword> 

く / cmd> 

</cmdstore> 


The statement <configPassword intervai="i0 n > will force the user to change his/her password every ten days. 


ResetAIIUsers.xml 


The following code allows you to reset original default status for all accounts. 


く ？ xml version="l.0" encodinq= n utf-8"?> 

<cmdstore xmlns : xsi="http :// www.w3.org/2001/XMLSchema-instance" 
xsi : noNamespaceSchemaLocation=" DVMRemoteCmd.xsd"> 

<cmd> 

<allUser action= n resetUser"></allUser> 

く / cmd> 

</cmdstore> 








ResetUser.xml 


The following code allows you to reset original default status for specific accounts. 


く ？ xml version= 〃 l•0 〃 encoding= 〃 utf 一 8〃？> 

<cmdstore xmlns : xsi="http :/ /www.w3.org/2001/XMLSchema-instance" 
xsi : noNamespaceSchemaLocation= n DVMRemoteCmd.xsd"> 

<cmd> 

<singleUser action="resetUser 〃 user="User"></singleUser> 
く / cmd> 

</cmdstore> 


If the <singleUser action=’’resetUser’’ user=’’User’’> Statement above is changed to <singleUser action=’’resetUser’’ 
user= 〃 abcd.efgh〃>, then the abcd.efgh account will be reset to its initial default status. 


MultiCommands.xml 


You can run multiple commands in an XML file. The following example shows that you can reset multiple individual users 
back to their initial default status; and in the same file you can specify that other individual multiple users will be notified that 
they must change their passwords. 


<?xml version="1.0" encodinq= n utf-8"?> 

<cmdstore xmlns : xsi="http :/ /www.w3.org/2 001 /XMLSchema-instance" 
xsi : noNamespaceSchema_Location= n DVMRemoteCmd. xsd"> 

<cmd> 

<singleUser action="resetUser" user= n Userl n x/singleUser> 

</cmd> 

<cmd> 

<singleUser action="resetUser" user="User2"></singleUser> 

</cmd> 

<cmd> 

<singleUser action="changePassword" user="abcd.efgh n x/singleUser> 
</cmd> 

<cmd> 


<singleUser action="changePassword" user="ijkl.mnop n x/singleUser> 
く / cmd> 

</cmdstore> 


In the above example, the ” Userl” and ”User2” accounts will be reset, and the ” abcd.efgh” and ” ijkl.mnop” accounts 
will be notified that they must change their password. 
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Preparing Self-Extracting (SFX) Files for Software 
Dispatch 

Due to the fact that neither Microsoft® Systems Management Server (SMS) nor Microsoft® System Center Configuration 
Manager (SCCM) can dispatch the XML configuration file, you must package the individual BTFremote.exe, XML Configuration 
file, and XML Schema file into a compressed file using, for instance, WinRAR or WinZip software. 

The example below lists the steps to create a self-extracting executable SFX file program (.exe) using WinRAR. NOTE: The 
exact user interface of WinRAR may vary depending on your version of WinRAR. 

1.In the File Explorer window, select each file to be included in the SFX archive for dispatching. For example, let's assume 
you select files named BTFRemote.exe, ChangeAllUsersPassword.xml, and DVMRemoteCmd.xsd. 

2. Right-click on the group of files. In the right-click pop-up menu, select the Add to archive... command. 

3. A dialog box opens which (among many other options) lets you: 

• Assign a filename (by default, the parent folder name is used). 

• Select the RAR archive format. 

• Select the desired Archiving Options. 

4. Click OK to create the _rar file. 

5. Double-click on the newly-created .rar archive file. 

6. Click the SFX icon in the Toolbar of the WinRAR window. 

7. In the dialog box that opens, click the Advanced SFX options... button. 

8. In the Advanced SFX Options dialog box, select the Create in the current folder button. 

9. In the Setup program/Run after extraction field, enter the name of the .exe file (which, in this example, would be 

BTFRemote.exe). 

10. Click OK. You will then see that the .exe (self-extracting) file has been created. Use this file in the SMS or SCCM server 
to dispatch the Latitude ON Flash configuration settings. 


yjy NOTE: It is important to remember that the SFX self-extracting .exe file must be set up as a silent installation. The 
* command to do this must be entered in the Command line field of the Program Properties dialog box. The first 
part of the command consists of the .exe command name, and is followed by the options /s /v"qn. So, for example, 
if the SFX file you created is named Dispatch.exe, then the command to push it for silent installation would be: 

Dispatch.exe /s /v"qn 
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Upgrading Latitude ON™ Flash to Clients Remotely 

The System Administrator can update selected clients, or all clients, to a new version of Latitude ON Flash, remotely and 
transparently to the users. This can be done using the Microsoft® SMS (Systems Management Server) software delivery 
service. You must set the upgrade to run silently. 

When upgrading, the Administrator can choose to: 

• Preserve all the user's specific current settings 

• Preserve all basic accounts but re-set the user settings 

• Delete all accounts and treat the upgrade as a new installation 

This is accomplished with the following command line parameters. The desired command must be entered into the 
Command line field of the Program Properties dialog box (General tab). 

Setup.exe /s /v"qn MODE=X" 

where X is the mode number. 

1. MODE=l is the default value, if no value is assigned. This command line would upgrade to a newer version of Latitude 
ON Flash and would retain all user data. 

2. MODE=2 retains all existing accounts and passwords, but it will clear all other user data when updating Latitude ON Flash. 

3. MODE=3 deletes all accounts and treats the Latitude ON Flash upgrade as a new installation. 


Back to Contents Paqe 


20091002 a 




Back to Contents Paqe 


Reference A: XML Schema for Latitude ON™ Flash 

The following is provided for your reference. 

DVM Remote Command XSD file (DVMRemoteCMD.xsd) 


く？ xml version="1.0" encoding="utf-8" ?> 

<xs:schema elementFormDefault 二 " qualified" xmlns:xs 二 " http://www.w3.org/2001/XMLSchema"> 
<xs:simpleType name="dvmCmd "> 

<xs:restriction base="xs:string"> 

<xs:enumeration value="deletellser" /> 

<xs:enumeration value="resetUser" /> 

<xs:enumeration value="changePassword" /> 

</xs:restriction> 

</xs:simpleType> 

<xs:complexType name="cmdType"> 

<xs:choice> 

<xs:element name="singleUser"> 

<xs:complexType> 

<xs:attribute name="action" type="dvmCmd" use="required" /> 

<xs:attribute name="user" type 二 " xs:string" use="required" /> 

</xs:complexType> 

</xs:element> 

<xs:element name="allUser"> 

<xs:complexType> 

<xs:attribute name="action" type 二 " dvmCmd" use="required" /> 

</xs : co m plexT ype> 

</xs:element> 

<xs:element name="configPassword"> 

<xs:complexType> 

<xs:attribute name="interval" type =, 'xs: unsigned I nt" use 二 ’ 'required" /> 
</xs:complexType> 

</xs:element> 

<xs:element name="configPower"> 

<xs:complexType> 

<xs:sequence> 

<xs:element minOccurs="1 " maxOccurs="1 " name="battery"> 

<xs:complexType> 

<xs:attribute name="backlight" type="xs:unsignedlnt" use="required" /> 

<xs:attribute name="poweroff" type="xs:unsignedlnt" use="required" /> 

</xs : co m p I exTy pe > 

</xs:element> 

<xs:element minOccurs="1 " maxOccurs="1 " name="acpower"> 

<xs:complexType> 

<xs:attribute name="backlight" type="xs:unsignedlnt" use="required" /> 

<xs:attribute name 二 " poweroff" type="xs:unsignedlnt" use="required" /> 
</xs:complexType> 

</xs:element> 

</xs:sequence> 

</xs:complexType> 

</xs:element> 

</xs:choice> 

</xs:complexType> 

<xs:complexType name 二 " cmdstoreType"> 

<xs:sequence minOccurs="1 " maxOccurs="unbounded "> 

<xs:element name="cmd" type="cmdType" /> 

</xs:sequence> 

</xs:compl exT ype> 

<xs:element name="cmdstore" type="cmdstore Type" /> 

</xs:schema> 
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